home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds / ps.man < prev    next >
Text File  |  1989-07-31  |  6KB  |  162 lines
  1. ' $Header: /a/newcmds/ps/RCS/ps.man,v 1.4 89/07/31 17:50:52 douglis Exp $ SPRITE (Berkeley)
  2. .so \*(]ltmac.sprite
  3. .HS PS cmds
  4. .BS
  5. .SH NAME
  6. ps \- print process status information
  7. .SH SYNOPSIS
  8. \fBps \fR[\fIoption(s)\fR] [\fIpid pid\fR ...]
  9. .SH OPTIONS
  10. .IP "\fB\-a\fR" 14
  11. Print out information for processes belonging to all users (normally
  12. only the invoking user's processes are printed).
  13. .IP "\fB\-A\fR" 14
  14. Print out information for absolutely all processes, even dead ones.
  15. .IP "\fB\-d\fR" 14
  16. Print information only for processes in DEBUG state.
  17. .IP "\fB\-help\fR" 14
  18. Print out a help message and exit without doing anything else.
  19. .IP "\fB\-i\fR" 14
  20. Instead of the default status information, print information about
  21. various process ids (includes the PID, PPID, GROUP, USER, RUSER, TIME,
  22. and COMMAND fields).
  23. .IP "\fB\-k\fR" 14
  24. Print out information for kernel server processes in addition to
  25. any other processes requested with other switches.
  26. .IP "\fB\-l\fR" 14
  27. Use local information for migrated processes rather than following
  28. them to their current hosts.
  29. .IP "\fB\-m\fR" 14
  30. Print information only for processes that are
  31. migrated to or from another machine.
  32. .IP "\fB\-M\fR" 14
  33. Instead of the default status information, print information about
  34. process migration (includes the PID, STATE, FLAGS, EVENT, RNODE, RPID,
  35. and COMMAND fields).  
  36. .IP "\fB\-s\fR" 14
  37. Instead of the default status information, print information about
  38. signals (includes the PID, PENDING, HELD, IGNORE, HANDLE,
  39. and COMMAND fields).
  40. .IP "\fB\-u\fR" 14
  41. Instead of the default status information, print additional
  42. ``user-oriented'' information, including PID, %CPU, %MEM, SIZE, RSS,
  43. STATE, TIME, PRI, and COMMAND.
  44. .IP "\fB\-v\fR" 14
  45. Instead of the default status information, print virtual memory
  46. information (includes the PID, CODSZ, CODRS, HPSZ, HPRS, STKSZ, STKRS,
  47. SIZE, RSS, and COMMAND fields).
  48. .IP "\fB\-w \fIlineWidth\fR" 14
  49. Use \fIlineWidth\fR as the output line length, and format output so that
  50. it fits neatly on lines of this length.  The COMMAND field gets truncated
  51. as necessary to accomplish this. 
  52. .BE
  53.  
  54. .SH DESCRIPTION
  55. .LP
  56. This command prints out process status information.
  57. If one or more \fIpid\fR's is given, then information is printed
  58. for those processes.  If no \fIpid\fR is given, then information is
  59. printed for all processes belonging to the invoking user (additional
  60. processes may be requested with switches like \fB\-a\fR).
  61. .LP
  62. By default, \fBps\fR prints a short status report for each process, containing
  63. the PID, STATE, TIME, and COMMAND fields.  Other forms of printout are
  64. available using switches like \fB\-u\fR and \fB\-m\fR.
  65.  
  66. .SH FIELDS
  67. .LP
  68. The names of fields printed by \fBps\fR (which appear at the tops of the
  69. columns of \fBps\fR printout), and the meaning of the information printed
  70. in the fields, are:
  71. .IP \fBCODRS\fR 13
  72. The amount of physical memory occupied by this process's code
  73. segment, in units of 1024 bytes.
  74. .IP \fBCODSZ\fR 13
  75. The total size of this process's code segment, in units of 1024 bytes.
  76. Not all of this is necessarily resident in memory.
  77. .IP \fBCOMMAND\fR 13
  78. The command that the process is executing.  This field gets truncated
  79. if necessary to avoid running off the end of the line.  Use the \fB\-w\fR
  80. switch to request a longer line size when needed.
  81. .IP \fBEVENT\fR 13
  82. The \fIevent\fR field from the process control block (printed in
  83. hexadecimal).  See the include file <kernel/proc.h> for further
  84. information.
  85. .IP \fBFLAGS\fR 13
  86. The \fIgenFlags\fR field from the process control block (printed in
  87. hexadecimal).  See the include file <kernel/proc.h> for further
  88. information.
  89. .IP \fBGROUP\fR 13
  90. The process group to which this process belongs.
  91. .IP \fBHANDLE\fR 13
  92. A hexadecimal value giving a bit-mask of the signals for which the process
  93. has specified handler procedures.
  94. .IP \fBHELD\fR 13
  95. A hexadecimal value giving a bit-mask of the signals currently ``held''
  96. (prevented from being delivered to the process at its request).
  97. .IP \fBHPRS\fR 13
  98. The amount of physical memory occupied by this process's heap segment,
  99. in units of 1024 bytes.
  100. .IP \fBHPSZ\fR 13
  101. The total size of this process's heap segment, in units of 1024 bytes.
  102. .IP \fBIGNORE\fR 13
  103. A hexadecimal value giving a bit-mask of the signals currently being
  104. ignored by the process
  105. .IP \fBPID\fR 13
  106. The process ID for the process.
  107. .IP \fBPPID\fR 13
  108. The process id of the parent of this process.
  109. .IP \fBPRI\fR 13
  110. The priority of the process.  Processes with normal priority have no
  111. specific priority listed.  Server processes, with infinite priority,
  112. are listed as "S". 
  113. Processes with above-normal priority are
  114. listed
  115. as ">", and processes with below-normal priority are listed as "<".
  116. Processes with VERY_LOW_PRIORITY are listed as "<<".
  117. .IP \fBPENDING\fR 13
  118. A hexadecimal value giving a bit-mask of the signals that are awaiting
  119. delivery to the process.
  120. .IP \fBRNODE\fR 13
  121. For a migrated process, this identifies the ``other'' node that the
  122. process belongs to (its home node if this is the remote node, or
  123. vice versa).
  124. .IP \fBRPID\fR 13
  125. For a migrated process, this contains the id of the process on its
  126. ``other'' node (its home node if this is the remote node, or
  127. vice versa).
  128. .IP \fBRSS\fR 13
  129. Resident set size:  the total physical memory occupied by this
  130. process, in units of 1024 bytes.  This is the sum of CODRS, HPRS, and
  131. STKRS.
  132. .IP \fBRUSER\fR 13
  133. The name of the user corresponding to the real user ID of this process.
  134. .IP \fBSIZE\fR 13
  135. The total amount of virtual memory allocated to this process,
  136. in units of 1024 bytes.  Not all
  137. of this memory is necessary resident in physical memory, and some of it
  138. may not even have been accessed.  SIZE is equal to the sum of
  139. CODSZ, HPSZ, and STKSZ.
  140. .IP \fBSTATE\fR 13
  141. The current execution state of the process.
  142. .IP \fBSTKRS\fR 13
  143. The amount of physical memory occupied by this process's stack segment,
  144. in units of 1024 bytes.
  145. .IP \fBSTKSZ\fR 13
  146. The total size of this process's heap segment, in units of 1024 bytes.
  147. .IP \fBTIME\fR 13
  148. The total CPU time consumed by the process, in minutes and seconds.
  149. This time includes both kernel and user time.
  150. .IP \fBUSER\fR 13
  151. The user name corresponding to the effective user ID of this process.
  152. .IP \fB%CPU\fR 13
  153. A smoothed average of the fraction of a CPU that this process has
  154. consumed over the last several seconds.
  155. .IP \fB%MEM\fR 13
  156. The fraction of total physical memory occupied by this process's
  157. segments.  Does not include memory that belongs to the process
  158. but is swapped out.
  159.  
  160. .SH KEYWORDS
  161. process, status
  162.